home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / clipper / ks94an.zip / WSSVSCR.HDR < prev    next >
Text File  |  1994-04-25  |  1KB  |  47 lines
  1. /******************************************************************************
  2.                  The Klipper Library, for CA-Clipper 5.x
  3.         Copyright (c), 1994, Wallace Information Systems Engineering
  4.  
  5. FUNCTION:
  6.  
  7. __WSSaveScreen( nHandle ) --> NIL
  8.  
  9. PARAMETERS:
  10.  
  11. nHandle : File name from previous fopen()/fcreate()
  12.  
  13. SHORT:
  14.  
  15. Save screen to existing and already open file, in WordStar format.
  16.  
  17. DESCRIPTION:
  18.  
  19. __WSSaveScreen() is identical to _WSSaveScreen() except that in this case
  20. you pass the handle of an already opened or created file.
  21.  
  22. The contents of the screen are written to this file handle and the
  23. handle remains open when the function returns.
  24.  
  25. It is useful in situations where you want to save the screen contents to
  26. a file and then continue writing other information to the same file, but
  27. you do not want to have to reopen the file following _SaveScreen()
  28. (which closes the file when done).
  29.  
  30. For an example, see _Prepare(), which uses the __SaveScreen()
  31. counterpart function in it's error recording errorblock function.
  32.  
  33. NOTE:
  34.  
  35.  
  36.  
  37. EXAMPLE:
  38.  
  39. __WsSaveSceen( nHandle )
  40.  
  41. Result: The screen is saved in WordStar format to the already open file
  42. specified by nHandle).
  43.  
  44. __WsSaveScreen() appends to any existing data in the file.
  45.  
  46. ******************************************************************************/
  47.